home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / restls.zip / READ_ME.BTM < prev    next >
Text File  |  1991-11-20  |  13KB  |  235 lines
  1. ** How to use Mr. Bitmap **
  2.  
  3. This utility will allow you to scan through an .EXE or .DLL file and view
  4. all bitmaps present.  By using the right arrow button, the next bitmap will be
  5. displayed and by using the left arrow button the previously viewed bitmap can
  6. be brought back and displayed.  The right and left arrow keys of the keyboard
  7. can also be used to view bitmaps.
  8.  
  9. If the Save button is pressed, a filename may be entered and the currently
  10. visible bitmap will be saved into a file with the .BMP format.  You will be
  11. presented with a dialog box asking for a file name.  A file name is
  12. selected via the file and directory listboxes or by typing the file name
  13. (and if the file is not in the current directory, the complete file
  14. path) into the edit control above the file name listbox.  When the OK
  15. button is pressed, the bitmap will be saved.  If the cancel button is
  16. pressed, the bitmap will not be saved.
  17.  
  18. If the Replace button is pressed, you will be presented with a dialog box
  19. containing an edit field filled with the name of the currently viewed
  20. bitmap.  If you wish to change the name or number of this bitmap, you may type
  21. what you wish in this edit field.  If the Cancel button is pressed at this
  22. time the name of the bitmap will NOT be changed.  If the OK button is 
  23. pressed the name of that bitmap will immediatly be changed in the file and
  24. you will be presented with a file selection dialog box.  This box contains a
  25. list of all files with the .BMP extension in your current directory, and a
  26. list of directories and drives to which you can also look.  A file name is
  27. selected via the file and directory listboxes or by typing the file name
  28. (and if the file is not in the current directory, the complete file
  29. path) into the edit control above the file name listbox.  If the OK button
  30. is pressed the selected bitmap file will be used to replace the bitmap
  31. currently being viewed by Mr. Bitmap.  If the Cancel button is pressed,
  32. the currently viewed bitmap will NOT be changed.
  33.  
  34. If the Add button is pressed, you will be presented with a dialog box
  35. containing a list of all files with the .BMP extension.  A file name is
  36. selected via the file and directory listboxes or by typing the file name
  37. (and if the file is not in the current directory, the complete file
  38. path) into the edit control above the file name listbox.  If you press
  39. Cancel at this time no bitmap will be added to the file.  If you select a
  40. .BMP file from this list and press the OK button, a dialog box will appear
  41. with an edit field asking for an ID number or ID name for the bitmap you will
  42. be adding.  This ID number or name will be the same ID or name you will see
  43. in the "Bitmap Name:" field of the bitmap information displayed by Mr. Bitmap.
  44. When the OK button is pressed the cursor will change to an hourglass and
  45. there will be some disk activity as Mr. Bitmap readjusts the file and adds
  46. the bitmap.  If the Cancel button is pressed in the name dialog box, neither
  47. the bitmap nor the bitmap name will be added to the file.
  48.  
  49. NOTE: At this time, you can not add a bitmap to a program or DLL that
  50.       contains no resources.  Included with Mr. Bitmap is a DLL named
  51.       "emptydll.dll".  You may change this name to any name you desire.
  52.       If you wish to create a DLL with only your bitmaps in it, merely
  53.       add a bitmap of your own and delete the bitmap currently contained
  54.       in the "emptydll.dll" file.
  55.  
  56. If the Delete button is pressed the cursor will change to an hourglass
  57. and there will be some disk activity as Mr. Bitmap readjusts the file to
  58. remove the bitmap.
  59.  
  60. This program was created as a quick way to view and maintain bitmaps in
  61. executable programs and/or bitmap libraries (DLL's) since the available tools
  62. (e.g. The Whitewater Resource Toolkit and Borland Resource Workshop) require
  63. somewhat more time to perform minor functions such as this.  This should
  64. offer an easy way to quickly extract bitmaps that one wants and/or needs.
  65. Due to the fact that the Paint program included with Windows 3.0 supports the
  66. Windows .BMP format, I've not included an editor in this program.  Any bitmap
  67. extracted may be modified via Paint and then the Replace feature may be
  68. used to put the modified bitmap back into the EXE file.  I've tested this
  69. program by replacing card backs in the Solitaire program and it has worked
  70. quite well.
  71.  
  72. Mr. Bitmap can be run from DOS.  An introduction screen will appear that gives
  73. a brief synopsis of the program.  Pressing 'r' at this screen will run
  74. Windows and Mr. Bitmap, provided that Windows is in the path someplace.
  75. Mr. Bitmap can also be run with a file name as a parameter.  So, if you want
  76. to look at the file "sol.exe" and you are in DOS, you can type:
  77.  
  78.    mrbitmap sol.exe
  79.  
  80. at the DOS prompt and after the introduction screen is displayed merely
  81. press the 'r' key and Mr. Bitmap will run with sol.exe already open.
  82.  
  83. NOTE: Due to radically different formats, Windows Version 2.1 bitmaps can not
  84.       be read by this utility.  Some programs may run under both Windows 2.1 and
  85.       Windows 3.0.  An example of this is WinWord.  Bitmaps in such programs are
  86.       stored in Windows 2.1 format, and thus can not be read.  If a Windows 2.1
  87.       program is opened by Mr. Bitmap, an error message will appear saying that
  88.       the file is in Windows 2.1 format.
  89.  
  90. NOTE: PLEASE MAKE BACKUPS OF YOUR PROGRAMS SINCE Mr. Bitmap DOES NOT MAKE
  91.       BACKUPS!
  92.  
  93.  
  94. ** Product registration information **
  95.  
  96. If you find this program interesting and would like to hear about future
  97. enhancements and/or tools please send $25 to:
  98.  
  99.    Patrick Deupree
  100.    Iseult Technology
  101.    4500 Sojourn, #2606
  102.    Addison, TX 75248
  103.  
  104. If you are using Mr. Icon and/or Mr. Cursor as well, a single $40
  105. registration fee will cover information on all three products.
  106.  
  107. Please mail any comments you might have to the above address or send me
  108. e-mail on CompuServe at user ID 76427,442.  I urge people to make
  109. comments and suggestions as that is the only way to truly see what people
  110. like and do not like about a product.
  111.  
  112.  
  113. ** Changes from Bitmap Manager/Mr. Bitmap v1.0 **
  114.  
  115. Mr. Bitmap has gone through a name change since it was first written
  116. due to previously created programs by other shareware authors bearing
  117. the same name as Mr. Icon (previously Icon Manager).  In order to maintain
  118. some continuity between my Bitmap, Icon and Cursor programs, I changed the
  119. name of all three when the name of Mr. Icon changed.  I apologize for any
  120. confusion that may have occurred due to the name changes during the early
  121. months of these products.  As of about late May, the name of this product has
  122. been Mr. Bitmap.  The functional changes between Bitmap Manager and Mr. Bitmap
  123. were minimal, so I will merely cover the general changes from the early
  124. version to this current version.
  125.  
  126. Memory:   The original version of Mr. Bitmap would load all bitmaps read from a
  127.           file into memory.  This has now been changed.  The current mechanism
  128.           will only store the currently viewed bitmap in memory.  The minute
  129.           the next or previous buttons are pressed, the current bitmap will
  130.           be disposed of in memory and the next or previous bitmap will be
  131.           directly read from the file.
  132.  
  133. Speed:    The new Mr. Bitmap has a somewhat improved file adjustment mechanism
  134.           that makes replacement, addition and deletion somewhat faster than
  135.           they were or would have been before.
  136.  
  137. Features: The new Mr. Bitmap has three main features that were not present in
  138.           previous publicly released versions.  The first new feature is
  139.           the ability to change the name of the currently viewed bitmap in the
  140.           file.  The second is the ability to add bitmaps to a file.  The
  141.           third is the ability to delete bitmaps in a file.  More information
  142.           on each of these features may be found in the preceding section
  143.           telling how to use Mr. Bitmap.
  144.  
  145. Bugs:     The previous Mr. Bitmap did have a few bugs.  One of these was the
  146.           file open dialog box.  Previously, typing a file path directly into
  147.           the edit control above the file list box would not successfully
  148.           open the file.  In addition, trying to edit files on the root
  149.           directory of any drive caused a few problems.  All of these bugs
  150.           have been fixed.
  151.  
  152.           Another bug that existed previously involved opening more than one
  153.           session of the Mr. Bitmap program.  The square that actually displayed
  154.           the bitmap would exhibit some odd behavior (e.g. opening a second
  155.           session of Mr. Bitmap would cause the display area of the first
  156.           session to be filled with the second sessions Bitmap).  This has
  157.           been fixed as well.
  158.  
  159.  
  160. ** Registration reminders **
  161.  
  162. I've not put an "automatic" about box or timed registration reminder in this
  163. program, the reason being I've always found such things annoying, most
  164. people ignore them, and it's a waste of time to write the code that does
  165. so.
  166.  
  167.  
  168. ** Development Tools **
  169.  
  170. You will notice that this program was created in two parts, one of which
  171. being a Dynamic Link Library.  The "ToolLib.DLL" file contains various
  172. code sets that perform the following actions:
  173.  
  174. resinfo: This contains functions oriented toward the following purposes:
  175.          Retrieving a list of all ID's within the file of a certain
  176.               resource type.
  177.          Adjusting the ID's of resources to accomodate insertion/deletion.
  178.          Retrieving data for a specific resource type and ID.
  179.          Modifying data for a specific resource type and ID.
  180.          Adding a resource to an file either before a specified ID
  181.               or at the end of the resources of that type.
  182.          Deleting data for a specific resource type and ID.
  183.  
  184.     bitmaps: This currently contains two major functions.  One will read
  185.              a .BMP file and return its file header information, and its
  186.              bitmap information.  The other will write a .BMP file given
  187.              just the bitmap information (the function will create the
  188.              file header based on information in the bitmap).
  189.  
  190.     icons:   This currently contains three major functions.  One will read
  191.              a .ICO file and return its file header information, and its
  192.              actual icon information.  The other two functions deal with
  193.              writing icons to a file.  One will save an icon group given
  194.              the icon header from an EXE file and a list of handles containing
  195.              the individual icons that are to be saved in the group.  The
  196.              other will save a single icon and create the icon file header
  197.              to accommodate that single icon.
  198.  
  199.     cursors: This currently contains two major functions.  One will read
  200.              a .CUR file and return its file header information, and its
  201.              actual cursor information.  The second function will save
  202.              cursor information to a file.  This function will create
  203.              the cursor file header for you and the cursor information is
  204.              expected in the same format as it is stored in an executable
  205.              file (that is, the cursor information is preceded by two
  206.              numbers representing the X and Y position of the hot-spot).
  207.  
  208.     bitview: This is a window class that will display a bitmap, cursor, or
  209.              icon of a size less than 64K.  If the item being displayed
  210.              is larger than the set space for the window, scroll bars will
  211.              appear automatically and all scrolling is handled by the
  212.              window class.
  213.  
  214.     names:   This is a set of functions used to manipulate the name table
  215.              of an EXE files resources.
  216.              This contains functions oriented toward the following purposes:
  217.              Addition of a name to the name table.
  218.              Deletion of a name from the name table.
  219.              Retrieval of a name given the items type and ID.
  220.              Comparison of a name, to find if it already exists in the table.
  221.  
  222.     Documentation for this DLL is available, though I've not yet set a
  223.     price for it.
  224.  
  225. In addition to these tool sets, I've created a DOS program that will extract
  226. Icon, Bitmap, and Cursor resources from an executable or resource file and
  227. will also display information on Dialog, Menu, and String entries (such
  228. as name, and info on menu items and controls such as item width, item ID, and
  229. item name).
  230.  
  231. The reason I mention these is that I would be interested in finding out how
  232. many people would like these tools.  I make no promises as to the
  233. availability of these tools as how much work I put into them depends on
  234. how much interest there is.
  235.